package com.xuetang.mapper;

import com.xuetang.entity.CommunityPost;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 社区帖子Mapper接口
 */
@Mapper
public interface CommunityPostMapper {

    /**
     * 分页查询帖子列表
     * 
     * @param offset 偏移量
     * @param limit  每页条数
     * @param tagId  标签ID，为null时查询所有
     * @return 帖子列表
     */
    List<CommunityPost> listByPage(@Param("offset") int offset, @Param("limit") int limit,
            @Param("tagId") Integer tagId);

    /**
     * 统计帖子总数
     * 
     * @param tagId 标签ID，为null时统计所有
     * @return 帖子总数
     */
    int countPosts(@Param("tagId") Integer tagId);

    /**
     * 根据ID查询帖子
     * 
     * @param id 帖子ID
     * @return 帖子信息
     */
    CommunityPost getById(@Param("id") Long id);

    /**
     * 插入帖子
     * 
     * @param post 帖子信息
     * @return 影响行数
     */
    int insert(CommunityPost post);

    /**
     * 更新帖子
     * 
     * @param post 帖子信息
     * @return 影响行数
     */
    int update(CommunityPost post);

    /**
     * 更新帖子点赞数
     * 
     * @param id        帖子ID
     * @param increment 增量，可为正可为负
     * @return 影响行数
     */
    int updateLikes(@Param("id") Long id, @Param("increment") int increment);

    /**
     * 删除帖子
     * 
     * @param id 帖子ID
     * @return 影响行数
     */
    int delete(@Param("id") Long id);

    /**
     * 查询最近的帖子列表（用于后台管理系统）
     * 
     * @param limit 条数
     * @return 帖子列表
     */
    List<CommunityPost> listRecent(@Param("limit") int limit);
}